SGI Freeware 1999 August

home *** CD-ROM | disk | FTP | other *** search

/ SGI Freeware 1999 August / SGI Freeware 1999 August.iso / dist / fw_qt.idb / usr / freeware / catman / p_man / cat3 / qglwidget.Z / qglwidget

Wrap

Text File | 1998-10-28 | 18.6 KB | 331 lines

QQQQGGGGLLLLWWWWiiiiddddggggeeeetttt((((3333qqqqtttt)))) TTTTrrrroooollllllll TTTTeeeecccchhhh AAAASSSS ((((9999 JJJJuuuullllyyyy 1111999999998888)))) QQQQGGGGLLLLWWWWiiiiddddggggeeeetttt((((3333qqqqtttt)))) NNNNAAAAMMMMEEEE QGLWidget - Widget for rendering OpenGL graphics [Qt OpenGL Extension] SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS #include <qgl.h> Inherits QWidget. PPPPuuuubbbblllliiiicccc MMMMeeeemmmmbbbbeeeerrrrssss QQQQGGGGLLLLWWWWiiiiddddggggeeeetttt (((( QQQQWWWWiiiiddddggggeeeetttt **** _p_a_r_e_n_t====0000,,,, ccccoooonnnnsssstttt cccchhhhaaaarrrr **** _n_a_m_e====0000,,,, ccccoooonnnnsssstttt QQQQGGGGLLLLWWWWiiiiddddggggeeeetttt **** _s_h_a_r_e_W_i_d_g_e_t QQQQGGGGLLLLWWWWiiiiddddggggeeeetttt (((( ccccoooonnnnsssstttt QQQQGGGGLLLLFFFFoooorrrrmmmmaaaatttt &&&& _f_o_r_m_a_t,,,, QQQQWWWWiiiiddddggggeeeetttt **** _p_a_r_e_n_t====0000,,,, ccccoooonnnnsssstttt cccchhhhaaaarrrr **** _n_a_m_e ~~~~QQQQGGGGLLLLWWWWiiiiddddggggeeeetttt () bbbboooooooollll iiiissssVVVVaaaalllliiiidddd (((()))) ccccoooonnnnsssstttt vvvvooooiiiidddd mmmmaaaakkkkeeeeCCCCuuuurrrrrrrreeeennnntttt (((()))) bbbboooooooollll ddddoooouuuubbbblllleeeeBBBBuuuuffffffffeeeerrrr (((()))) ccccoooonnnnsssstttt vvvvooooiiiidddd sssswwwwaaaappppBBBBuuuuffffffffeeeerrrrssss (((()))) ccccoooonnnnsssstttt QQQQGGGGLLLLFFFFoooorrrrmmmmaaaatttt&&&& ffffoooorrrrmmmmaaaatttt (((()))) ccccoooonnnnsssstttt vvvvooooiiiidddd sssseeeettttFFFFoooorrrrmmmmaaaatttt (((( ccccoooonnnnsssstttt QQQQGGGGLLLLFFFFoooorrrrmmmmaaaatttt &&&& ffffoooorrrrmmmmaaaatttt )))) ccccoooonnnnsssstttt QQQQGGGGLLLLCCCCoooonnnntttteeeexxxxtttt**** ccccoooonnnntttteeeexxxxtttt (((()))) ccccoooonnnnsssstttt vvvvooooiiiidddd sssseeeettttCCCCoooonnnntttteeeexxxxtttt (((( QQQQGGGGLLLLCCCCoooonnnntttteeeexxxxtttt **** _c_o_n_t_e_x_t,,,, ccccoooonnnnsssstttt QQQQGGGGLLLLCCCCoooonnnntttteeeexxxxtttt **** _s_h_a_r_e_C_o_n_t_e_x_t ==== 0000 )))) PPPPuuuubbbblllliiiicccc SSSSlllloooottttssss vvvvooooiiiidddd uuuuppppddddaaaatttteeeeGGGGLLLL (((()))) PPPPrrrrooootttteeeecccctttteeeedddd MMMMeeeemmmmbbbbeeeerrrrssss vvvviiiirrrrttttuuuuaaaallll vvvvooooiiiidddd iiiinnnniiiittttiiiiaaaalllliiiizzzzeeeeGGGGLLLL (((()))) vvvviiiirrrrttttuuuuaaaallll vvvvooooiiiidddd ppppaaaaiiiinnnnttttGGGGLLLL (((()))) vvvviiiirrrrttttuuuuaaaallll vvvvooooiiiidddd rrrreeeessssiiiizzzzeeeeGGGGLLLL (((( iiiinnnntttt _w,,,, iiiinnnntttt hhhh )))) vvvviiiirrrrttttuuuuaaaallll vvvvooooiiiidddd ppppaaaaiiiinnnnttttEEEEvvvveeeennnntttt (((( QQQQPPPPaaaaiiiinnnnttttEEEEvvvveeeennnntttt **** )))) vvvviiiirrrrttttuuuuaaaallll vvvvooooiiiidddd rrrreeeessssiiiizzzzeeeeEEEEvvvveeeennnntttt (((( QQQQRRRReeeessssiiiizzzzeeeeEEEEvvvveeeennnntttt **** )))) DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN This class is defined in the QQQQtttt OOOOppppeeeennnnGGGGLLLL EEEExxxxtttteeeennnnssssiiiioooonnnn, which can be found in the qt/extensions directory. It is not included in the main Qt API. The QGLWidget class is a widget for rendering OpenGL graphics. It is easy to render OpenGL graphics in Qt applications. You can create a subclass of QGLWidget and reimplement two functions: resizeGL() and paintGL(). The resizeGL() method is called whenever the widget has been resized (and also when it shown for the first time, since all newly created widgets get a resize event automatically). paintGL() is called when the widget needs to be updated. class MyGLDrawer : public QGLWidget Page 1 (printed 9/22/98) QQQQGGGGLLLLWWWWiiiiddddggggeeeetttt((((3333qqqqtttt)))) TTTTrrrroooollllllll TTTTeeeecccchhhh AAAASSSS ((((9999 JJJJuuuullllyyyy 1111999999998888)))) QQQQGGGGLLLLWWWWiiiiddddggggeeeetttt((((3333qqqqtttt)))) { Q_OBJECT // include this if you use Qt signals/slots public: MyGLDrawer( QWidget *parent, const char *name ) : QGLWidget(parent,name) {} protected: void paintGL() { // draw the scene } void resizeGL( int w, int h ) { // setup viewport, projection etc. } }; If you need to repaint from other places than paintGL() (a typical example is when using timers to animate scenes), you can call the updateGL() function. When paintGL() or resizeGL() is called, your widget has been made current. If you need to call the standard OpenGL API functions from other places (e.g. in your widget's constructor), you must call makeCurrent() first. Like QGLContext, QGLWidget has advanced functions for requesting a new display format, and you can even set a new rendering context. MMMMEEEEMMMMBBBBEEEERRRR FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNN DDDDOOOOCCCCUUUUMMMMEEEENNNNTTTTAAAATTTTIIIIOOOONNNN QQQQGGGGLLLLWWWWiiiiddddggggeeeetttt::::::::QQQQGGGGLLLLWWWWiiiiddddggggeeeetttt (((( QQQQWWWWiiiiddddggggeeeetttt **** ppppaaaarrrreeeennnntttt====0000,,,, ccccoooonnnnsssstttt cccchhhhaaaarrrr **** nnnnaaaammmmeeee====0000,,,, ccccoooonnnnsssstttt QQQQGGGGLLLLWWWWiiiiddddggggeeeetttt **** sssshhhhaaaarrrreeeeWWWWiiiiddddggggeeeetttt ==== 0000,,,, WWWWFFFFllllaaaaggggssss ffff====0000 )))) Constructs an OpenGL widget with a _p_a_r_e_n_t widget and a _n_a_m_e. The default format is used. The _p_a_r_e_n_t, _n_a_m_e and _f arguments are passed to the QWidget constructor. If the _s_h_a_r_e_W_i_d_g_e_t parameter points to a valid QGLWidget, this widget will share OpenGL display lists with _s_h_a_r_e_W_i_d_g_e_t. Note: Initialization of OpenGL rendering state etc. should be done by overriding the initializeGL() function, not in the constructor of your QGLWidget subclass. See also: QGLFormat::defaultFormat(). QQQQGGGGLLLLWWWWiiiiddddggggeeeetttt::::::::QQQQGGGGLLLLWWWWiiiiddddggggeeeetttt (((( ccccoooonnnnsssstttt QQQQGGGGLLLLFFFFoooorrrrmmmmaaaatttt &&&& ffffoooorrrrmmmmaaaatttt,,,, QQQQWWWWiiiiddddggggeeeetttt **** ppppaaaarrrreeeennnntttt====0000,,,, ccccoooonnnnsssstttt cccchhhhaaaarrrr **** nnnnaaaammmmeeee====0000,,,, ccccoooonnnnsssstttt QQQQGGGGLLLLWWWWiiiiddddggggeeeetttt **** sssshhhhaaaarrrreeeeWWWWiiiiddddggggeeeetttt ==== 0000,,,, WWWWFFFFllllaaaaggggssss ffff====0000 )))) PPPPaaaaggggeeee 2222 ((((pppprrrriiiinnnntttteeeedddd 9999////22222222////99998888)))) QQQQGGGGLLLLWWWWiiiiddddggggeeeetttt((((3333qqqqtttt)))) TTTTrrrroooollllllll TTTTeeeecccchhhh AAAASSSS ((((9999 JJJJuuuullllyyyy 1111999999998888)))) QQQQGGGGLLLLWWWWiiiiddddggggeeeetttt((((3333qqqqtttt)))) Constructs an OpenGL widget with a _p_a_r_e_n_t widget and a _n_a_m_e. The _f_o_r_m_a_t argument specifies the rendering capabilities. The widget becomes invalid if the driver/hardware cannot satisfy the requested format. The _p_a_r_e_n_t, _n_a_m_e and _f arguments are passed to the QWidget constructor. If the _s_h_a_r_e_W_i_d_g_e_t parameter points to a valid QGLWidget, this widget will share OpenGL display lists with _s_h_a_r_e_W_i_d_g_e_t. Note: Initialization of OpenGL rendering state etc. should be done by overriding the initializeGL() function, not in the constructor of your QGLWidget subclass. See also: QGLFormat::defaultFormat() and isValid(). QQQQGGGGLLLLWWWWiiiiddddggggeeeetttt::::::::~~~~QQQQGGGGLLLLWWWWiiiiddddggggeeeetttt (((()))) Destroys the widget. ccccoooonnnnsssstttt QQQQGGGGLLLLCCCCoooonnnntttteeeexxxxtttt **** QQQQGGGGLLLLWWWWiiiiddddggggeeeetttt::::::::ccccoooonnnntttteeeexxxxtttt (((()))) ccccoooonnnnsssstttt Returns the current context. See also: setContext(). bbbboooooooollll QQQQGGGGLLLLWWWWiiiiddddggggeeeetttt::::::::ddddoooouuuubbbblllleeeeBBBBuuuuffffffffeeeerrrr (((()))) ccccoooonnnnsssstttt Returns TRUE if double buffering is set in the format for this widget. See also: QGLFormat::doubleBuffer(). ccccoooonnnnsssstttt QQQQGGGGLLLLFFFFoooorrrrmmmmaaaatttt &&&& QQQQGGGGLLLLWWWWiiiiddddggggeeeetttt::::::::ffffoooorrrrmmmmaaaatttt (((()))) ccccoooonnnnsssstttt Returns the widget's format. See also: setFormat(). vvvvooooiiiidddd QQQQGGGGLLLLWWWWiiiiddddggggeeeetttt::::::::iiiinnnniiiittttiiiiaaaalllliiiizzzzeeeeGGGGLLLL (((()))) [[[[vvvviiiirrrrttttuuuuaaaallll pppprrrrooootttteeeecccctttteeeedddd]]]] This virtual function is called one time before the first call to paintGL() or resizeGL(), and then one time whenever the widget has been assigned a new OpenGL context. Reimplement it in a subclass. This function should take care of setting OpenGL rendering flags, defining display lists, etc. There is no need to call makeCurrent() because this has already been done when this function is called. bbbboooooooollll QQQQGGGGLLLLWWWWiiiiddddggggeeeetttt::::::::iiiissssVVVVaaaalllliiiidddd (((()))) ccccoooonnnnsssstttt Returns TRUE if the widget was able to satisfy the specified Page 3 (printed 9/22/98) QQQQGGGGLLLLWWWWiiiiddddggggeeeetttt((((3333qqqqtttt)))) TTTTrrrroooollllllll TTTTeeeecccchhhh AAAASSSS ((((9999 JJJJuuuullllyyyy 1111999999998888)))) QQQQGGGGLLLLWWWWiiiiddddggggeeeetttt((((3333qqqqtttt)))) constraints. vvvvooooiiiidddd QQQQGGGGLLLLWWWWiiiiddddggggeeeetttt::::::::mmmmaaaakkkkeeeeCCCCuuuurrrrrrrreeeennnntttt (((()))) Makes this widget the current widget for OpenGL operations. I.e. makes this widget's rendering context the current OpenGL rendering context. vvvvooooiiiidddd QQQQGGGGLLLLWWWWiiiiddddggggeeeetttt::::::::ppppaaaaiiiinnnnttttEEEEvvvveeeennnntttt (((( QQQQPPPPaaaaiiiinnnnttttEEEEvvvveeeennnntttt **** )))) [[[[vvvviiiirrrrttttuuuuaaaallll pppprrrrooootttteeeecccctttteeeedddd]]]] Handles paint events. Calls the virtual function paintGL(). Reimplemented from QWidget. vvvvooooiiiidddd QQQQGGGGLLLLWWWWiiiiddddggggeeeetttt::::::::ppppaaaaiiiinnnnttttGGGGLLLL (((()))) [[[[vvvviiiirrrrttttuuuuaaaallll pppprrrrooootttteeeecccctttteeeedddd]]]] This virtual function is called whenever the widget needs to be painted. Reimplement it in a subclass. There is no need to call makeCurrent() because this has already been done when this function is called. vvvvooooiiiidddd QQQQGGGGLLLLWWWWiiiiddddggggeeeetttt::::::::rrrreeeessssiiiizzzzeeeeEEEEvvvveeeennnntttt (((( QQQQRRRReeeessssiiiizzzzeeeeEEEEvvvveeeennnntttt **** )))) [[[[vvvviiiirrrrttttuuuuaaaallll pppprrrrooootttteeeecccctttteeeedddd]]]] Handles resize events. Calls the virtual function resizeGL(). Reimplemented from QWidget. vvvvooooiiiidddd QQQQGGGGLLLLWWWWiiiiddddggggeeeetttt::::::::rrrreeeessssiiiizzzzeeeeGGGGLLLL (((( iiiinnnntttt wwwwiiiiddddtttthhhh,,,, iiiinnnntttt hhhheeeeiiiigggghhhhtttt )))) [[[[vvvviiiirrrrttttuuuuaaaallll pppprrrrooootttteeeecccctttteeeedddd]]]] This virtual function is called whenever the widget has been resized. Reimplement it in a subclass. There is no need to call makeCurrent() because this has already been done when this function is called. vvvvooooiiiidddd QQQQGGGGLLLLWWWWiiiiddddggggeeeetttt::::::::sssseeeettttCCCCoooonnnntttteeeexxxxtttt (((( QQQQGGGGLLLLCCCCoooonnnntttteeeexxxxtttt **** ccccoooonnnntttteeeexxxxtttt,,,, ccccoooonnnnsssstttt QQQQGGGGLLLLCCCCoooonnnntttteeeexxxxtttt **** sssshhhhaaaarrrreeeeCCCCoooonnnntttteeeexxxxtttt ==== 0000 )))) Sets a new context for this widget. The context must be created using _n_e_w. QGLWidget will delete the context when another context is set or when the widget is destroyed. Calling setContext() will not alter any display list sharing this widget currently has, unless you explicitly request sharing with a different context by giving a _s_h_a_r_e_C_o_n_t_e_x_t parameter that points to a valid context. See also: context() and setFormat(). vvvvooooiiiidddd QQQQGGGGLLLLWWWWiiiiddddggggeeeetttt::::::::sssseeeettttFFFFoooorrrrmmmmaaaatttt (((( ccccoooonnnnsssstttt QQQQGGGGLLLLFFFFoooorrrrmmmmaaaatttt &&&& ffffoooorrrrmmmmaaaatttt )))) Sets a new format for this widget. The widget becomes invalid if the requested format cannot be satisfied. Calling setFormat() will not alter any display list sharing Page 4 (printed 9/22/98) QQQQGGGGLLLLWWWWiiiiddddggggeeeetttt((((3333qqqqtttt)))) TTTTrrrroooollllllll TTTTeeeecccchhhh AAAASSSS ((((9999 JJJJuuuullllyyyy 1111999999998888)))) QQQQGGGGLLLLWWWWiiiiddddggggeeeetttt((((3333qqqqtttt)))) this widget currently has. See also: format(), setContext() and isValid(). vvvvooooiiiidddd QQQQGGGGLLLLWWWWiiiiddddggggeeeetttt::::::::sssswwwwaaaappppBBBBuuuuffffffffeeeerrrrssss (((()))) Swaps the screen contents with an off-screen buffer. Works only if the widget's format specifies double buffer mode. See also: doubleBuffer() and QGLFormat::setDoubleBuffer(). vvvvooooiiiidddd QQQQGGGGLLLLWWWWiiiiddddggggeeeetttt::::::::uuuuppppddddaaaatttteeeeGGGGLLLL (((()))) [[[[ssssllllooootttt]]]] Updates the widget by calling paintGL(). SSSSEEEEEEEE AAAALLLLSSSSOOOO hhhhttttttttpppp::::////////wwwwwwwwwwww....ttttrrrroooollllllll....nnnnoooo////qqqqtttt////qqqqggggllllwwwwiiiiddddggggeeeetttt....hhhhttttmmmmllll CCCCOOOOPPPPYYYYRRRRIIIIGGGGHHHHTTTT Copyright 1992-1997 Troll Tech AS. See the LICENSE file included in the distribution for a complete license statement. AAAAUUUUTTTTHHHHOOOORRRR Generated automatically from the source code. Page 5 (printed 9/22/98)